home *** CD-ROM | disk | FTP | other *** search
/ Mastering Computers 3 / Mastering Computers Vol 3.iso / Windows 3.1x / utils / TODOW104.ZIP / FM_UTILS.TXT < prev    next >
Encoding:
Text File  |  1993-06-17  |  4.4 KB  |  95 lines
  1. //***************************************************************************
  2. //
  3. //  Library:
  4. //      FM_UTILS.DLL - version 1.1a
  5. //
  6. //  Purpose:
  7. //      FM_UTILS is a File Manager extension DLL. An extension DLL adds
  8. //      a menu to File Manager, contains an entry point that processes menu
  9. //      commands and notification messages sent by File Manager, and
  10. //      queries data and information about the File Manager windows. The 
  11. //      purpose of an extension DLL is to add administration support 
  12. //      features to File Manager, for example, file and disk utilities.
  13. //      Up to five extension DLLs may be installed at any one time.
  14. //
  15. //      FM_UTILS adds a menu (called "Utilities" by default) to File Manager
  16. //      and processes all the messages that are sent by File Manager to an 
  17. //      extension DLL. In order to retrieve any information, it sends 
  18. //      messages to File Manager.
  19. //
  20. //  Usage:
  21. //      File Manager installs the extensions that have entries in the 
  22. //      [AddOns] section of the WINFILE.INI initialization file. An entry 
  23. //      consists of a tag and a value. To load FM_UTILS.DLL as a File 
  24. //      Manager extension, add the following to WINFILE.INI (assuming the 
  25. //      DLL resides in c:\win\system):
  26. //
  27. //          [AddOns]
  28. //          FM_Utils Extension=fm_utils.dll
  29. // 
  30. //      In addition, a section specific to this Extension DLL is added to
  31. //      WINFILE.INI. There are several elements to this section:
  32. //      For each utility to appear on the menu, there is a 'UserProgn=' tag,
  33. //      and a 'UserDescn=' tag. Comments (preceded by semicolons) are optional.
  34. //      You may have up to twenty separate utilities specified.
  35. //      You can also specify up to five utilities to load at the same time as
  36. //      FileMan, and exit when you close FileMan. You use the 'PreLoadn='
  37. //      tag for this. All of the utilities are started with the SW_SHOWMINNOACTIVE
  38. //      setting (minimized, but not activated).
  39. //      And, you can specify the name of the added menu. If you choose not to,
  40. //      the default is "&Utilities". This provides foreign language support,
  41. //      as well as allowing you to use a very short name, to keep the menu bar
  42. //      from growing too long. The tag to use is 'UserMenuName='.
  43. //
  44. //          [FM_Utils Extension]
  45. //          ;Name the menu
  46. //          UserMenuName=&Util
  47. //          ;add Upper Deck Editor to menu
  48. //          UserDesc1=&Edit File(s)
  49. //          UserProg1=D:\UDE\UDE.EXE
  50. //          ;add V. Buerg's LIST to menu
  51. //          UserDesc2=&View File(s)
  52. //          UserProg2=LIST.PIF
  53. //          ;PreLoad Trash Can
  54. //          PreLoad1=TRASH.EXE
  55. //
  56. //  Revision History:
  57. //      1.0 - March '92 - initial release
  58. //
  59. //      1.1 - April '92 - added ability to PreLoad utilities. This seems even
  60. //                  more popular than the original DLL.
  61. //
  62. //      1.1a - August '92 - added ability to specify menu name; changed
  63. //                  SendMessage(...WM_CLOSE...) to PostMessage(...WM_CLOSE...)
  64. //                  since it seemed to make more sense.
  65. //
  66. //  Notes:
  67. //      Portions of the base code for this utility is based on, and borrowed
  68. //      from, the XTENSION sample code provided with the Microsoft Windows
  69. //      3.1 SDK.
  70. //
  71. //      FM_UTILS attempts to close any auto-started utilities by posting a
  72. //      WM_CLOSE to it's main window. There's no guarantee that this method
  73. //      will work for *all* programs. If you know of a better way to handle
  74. //      this situation, I'd be *really* happy to hear about it.
  75. //
  76. //      While it's not properly documented anywhere, it seems that the maximum
  77. //      command line to pass to WinExec() is 128 characters. Since we have to
  78. //      pass in complete pathnames for all files in order for this to work,
  79. //      we may not be able to pass *all* selected file names.
  80. //
  81. //  Copyright (c) 1992 by Brad P. Smith - all rights reserved
  82. //
  83. //  snail:  R.R. #2 - 777 Crozier Rd.
  84. //          Oxford Mills, Ontario, CANADA
  85. //          K0G 1S0
  86. //
  87. //  E-Mail: 'B.P.Smith@BIX.com'
  88. //
  89. //      This utility DLL is FreeWare. Don't let *anybody* charge you for it.
  90. //      However, I would *really* appreciate hearing from you if you find
  91. //      FM_UTILS useful. Drop me a postcard or E-mail. I could use the moral
  92. //      support. :-)
  93. //
  94. //***************************************************************************
  95.